.. _ecUtl_IsTimeOut:

ecUtl_IsTimeOut
===============
---------------

SYNOPSYS
`````````````
.. code-block:: none

  t_bool ecUtl_IsTimeOut(
    t_ui32 dwStartTime_ms, 
    t_ui32 dwTimeOutVal_ms)


DESCRIPTION
`````````````

- 지정된 시간으로부터 지정한 제한 시간이 경과되었는지를 반환해주는 함수입니다. 

- 단, 기준이 되는 시작 시간은 윈도우 API 함수 중에서 timeGetTime() 함수를 사용해서 얻어진 값이어야 합니다.

- 이 함수는 타이머의 오버플로우까지 감안하여 오버플로우가 발생하여도 문제가 없도록 구현되었습니다.

- 이 함수들은 정수의 오버플로우(Overflow)까지 감안하여 두 정수의 편차값을 계산합니다.


PARAMETER
`````````````

- dwStartTime_ms : 타임아웃을 체크하기 위한 기준(시작) 시간. 이 값은 윈도우 API 함수 중에서 timeGetTime() 함수를 사용해서 얻어진 값이어야 합니다.

- dwTimeOutVal_ms : 제한 시간을 msec 단위로 지정합니다.


RETURN VALUE
`````````````

- 제한 시간이 경과되었는지의 여부를 반환합니다.


+-------+-----------------------------+
| Value | Meaning                     |
+=======+=============================+
| 0     | 제한 시간이 경과되지 않았음 |
+-------+-----------------------------+
| 1     | 제한 시간이 경과되었음      |
+-------+-----------------------------+


EXAMPLE
`````````````

.. code-block:: cpp
 :linenos:

 #include <mmsystem.h>
 UINT startTime = timeGetTime();
 while(ecUtl_IsTimeOut(startTime, 1000)){
      // 1000msec가 경과되기 전까지 대기……
 }